Inside Macintosh: QuickDraw GX Printing /

Chapter 4 - Advanced Printing Features / Advanced Printing Features Reference

Functions / Color Profile Functions

GXFindPrinterProfile

You can use the GXFindPrinterProfile function to determine the color profile used by an output printer.

OSErr GXFindPrinterProfile (gxPrinter thePrinter,
            void *searchData, long index,
            gxColorProfile *returnedProfile, long *numProfiles);

thePrinter

A reference to the printer object.

searchData

A pointer to a block of data that is assumed to be a ColorSync searching block of type CMProfileSearchRecord. If this value is not nil, then the value of the index parameter must not be 0 if you want the search to take place.

If this value is nil, the value of the index parameter defines which profile is returned.

index

The index of the profile to return. If the value is 0, then the current profile is returned in the returnedProfile parameter.

If the value of this parameter is not 0, then the behavior this function depends on the value of the searchData parameter. If index is not 0 and searchData is nil, the indexed profile is returned in the returnedProfile parameter. If index is not 0 and searchData is not nil, then the printer profiles are searched.

returnedProfile

On return, a list of references to color profiles matching the criteria specified by the searchData and index parameters. If no color profiles are found, this parameter is nil upon return.

numProfiles

On return, the number of profiles that were found.

function result

An error code. The value noErr indicates that the operation was successful.

DESCRIPTION

The GXFindPrinterProfile function searches for a color profile that matches the specifications in the searchData and index parameters.

RESULT CODES

gxSegmentLoadFailedErr

A required code segment could not be found, or there was not enough memory to load it.

SEE ALSO

The gxFindPrinterProfile message that determines which profiles are returned is described in Inside Macintosh: QuickDraw GX Printing Extensions and Drivers.

Color matching, color profiles, the CMProfileSearchRecord structure, and color profile resources are described in Inside Macintosh: Advanced Color Imaging.

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help